
LEVEL 68 

INTRODUCTION TO 
EMACS TEXT EDITOR 
ADDENDUM A 



SUBJECT 

Changes to the Manual 



SPECIAL INSTRUCTIONS 

This is the first addendum to CP31, Revision 0, dated March 1981. Refer to the 
Preface for "'Significant Changes”. 

Insert the attached pages into the manual according to the collating instruc- 
tions on the back of this cover. Throughout the manual, change bars in the 
margins indicate technical changes and additions; asterisks denote deletions. 
These changes will be incorporated in the next revision of this manual. 

Note: 

Insert this cover after the manual cover to indicate the updating of the 
document with Addendum A. 



SOFTWARE SUPPORTED 

Multics Software Release 10.1 



ORDER NUMBER 
CP31-00A 



February 1983 



36238 

6C183 

Printed in U.S.A. 



Honeywell 




COLLATING INSTRUCTIONS 



To update the manual, remove old pages and insert new pages as follows: 

Remove Insert 

iii through vii, blank iii through vii, blank 

7-1 through 7-3, blank 7-1 through 7-4 









The information and specifications in this document are subject to change without notice. This 
document contains information about Honeywell products or services that may not be available 
outside the United States. Consult your Honeywell Marketing Representative. 






© Honeywell Information Systems Inc., 1983 



File No.: 1L33, 1U33 



2/83 

CP31-00A 




Multics Emacs was modelled after the EMACS editor at the 
Massachusetts Institute of Technology (MIT) Artificial Intelligence 
Lab. EMACS was written, in TECO by staff members of the MIT AI 
Lab and the MIT Laboratory for Computer Science, without whose 
encouragement and support this project would not have been possible. 



Significant Changes in CP31 -00A 

The ~S (string-search) request now accepts a numeric argument. 

The ~R (reverse-string-search) request now accepts a numeric 
argument . 

The ESC % (query-replace) request now accepts six new responses. 

For purposes of clarity and ease of uSe, the MPM set has been 
reorganized. The six former MPM manuals, the Tools manual, and 
the RCP Users' Guide have been consolidated into a new set of 
three manuals: 

Multics Programmer's Reference Manual (AG91) 

contains all the reference material from the former eight 
manuals . 

Multics Commands and Active Functions (AG92) 

contains all the commands and active functions from the 
former eight manuals. 

Multics Subroutines and Input/Output Modules (AG93) 

contains all the subroutines and I/O modules from the 
former eight manuals. 

The following manuals are obsolete: 

Name 



MPM Peripheral Input/Output 
MPM Subsystem Writers' Guide 
Programming Tools 
MPM Communications I/O 
Resource Control Users' Guide 

References to the old MPM Commands manual still exist on pages 
not published with this addendum. When this manual is revised, 
the references in the text to the old manual will be changed to 
reflect the new organization. 



Order No. 

AX49 

AK92 

AZ03 

CC92 

CT38 
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SECTION 7 



SEARCHES AND SUBSTITUTIONS 



Searching is the term applied to the editor's method of locating 
a particular character sequence, or character string. You may 
want to do this simply to move the cursor to a portion of your 
text where some editing is required, or you may be seeking to 
replace a character string with something else. This latter 
replacement of one character string with another is termed 
substitution. Usually, the easiest way to make a substitution is 
to search for the string to be replaced, delete it when found, 
and type in the correction. However, occasionally you wish to 
replace a particular string throughout the buffer; the substitution 
requests serve that purpose. 



SEARCHING FOR A CHARACTER STRING 

Emacs provides two requests just for locating a character 
string, which yqu are prompted for. One of these searches forward 
from the current point to the qnd of the buffer. The other searches 
backward from the current point to the beginning of the buffer. 



~S AND ~R 

The A S request is named string-search, and searches forward. 
When you type it, you are prompted: 



String Search: 
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Type in the characters you wish located, exactly as you expect 
them to appear, including any spaces where required, and terminate 
the prompt with CR. If the search succeeds, the point is left 
immediately after the first occurrence of the character string. 
If no such string is found, the cursor does not move and Emacs 
responds in the minibuffer: 



Search fails. 



Responding to a search request’s prompt with only a carriage 
return reuses the last search string supplied (the default search 
string). Thus, you can locate several (or all) occurrences of 
the same string without continually retyping it. 

With a numeric argument, ~S searches forward for the specified 
occurrence of the string; e.g., ESC 5 ~S searches forward for the 
5th occurrence of the, string. If there aren’t 5 occurrences, it 
leaves the point immediately after the last occurrence, and gives 
you a message saying how many occurrences it found. 

The ''R request, reverse-string-search, searches backward through 
the buffer. It works just like ~S, except it leaves the point in 
front of the located string (so you do not keep locating the same 
string). Also, its prompt appears as: 



Reverse String Search: 



With a numeric argument, "R searches backward for the specif ied 
occurrence of the string. If there aren’t that many occurrences, 
it leaves the point in front of the last occurrence, and gives 
you a message saying how many occurrences it found. 



SUBSTITUTING ONE CHARACTER STRING FOR ANOTHER 



These next two requests search for a specified character string, 
which you are prompted for, and replace it with another, also 
prompted for. 
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ESC X replace and ESC % 



The ESC X replace extended request substitutes one string for 
another at all occurrences of the first string between the current 
point and the buffer's end. You are prompted for the string to 
be replaced, and then for the string that is to replace it. If 
no occurrences of the first string are found, the cursor does not 
move. Otherwise, the point is left after the last substituted 
string. 

The ESC % request, query-replace, allows you to substitute 
one string for another selectively . You are prompted for the 
search string and the replacement string individually; end each 
prompt with CR. This request searches forward for the first string, 
puts the point after it, and waits for one of the following responses 
(type the appropriate keys): 

space 

replaces this occurrence of the first string with the 
second. Then searches for the next occurrence of the 
first string and waits for a response again. 

CR 

leaves this occurrence of the first string unchanged and 
searches for the next occurrence of the first string, 
again waiting for a response after locating it. 

. (period) 

replaces this occurrence of the first string with the 
second and then terminates the query replace. 



leaves this occurrence of the first string unchanged and 
terminates the query replace. 



ESC 



same as ''G. 



i 



replaces all occurrences of the first string from the 
current point to the end, without querying again. 
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, (comma) 



replaces this occurrence of the first string with the 
second, immediately updating the screen. Then searches 
for the next occurrence of the first string and waits for 
a response again. 






"L 

redisplays the screen. 



displays a description of the allowable responses (i.e., 
prints this list) . 



? 

same as 

SUMMARY OF REQUESTS 
~S string-search 
~R reverse-string-search 
(ESC X) replace 
ESC % query-replace 
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